Yahtzee v2.0

Title:		Yahtzee v2.0
Author:		Peter Tooher (PETESOFTWARE)
E-Mail:		BigTSkills@excite.com
Website:	http://www.geocities.com/petesoftware

Version History of Yahtzee v2.0-
Version 1.0: The First Version of Yahtzee! Released February 2001. Publicly Released February 2001.
Version 2.0: Released May 2001. This version no longer needs prgm YINSTALL, is now in group format, and the Yahtzee Cheat Program v1.0 is now incorporated.

History of Yahtzee v2.0-
This is only my second game for the TI-83 Plus. I created this game because I had found an enjoyable game of Yahtzee elsewhere; however, I was unsatisfied with that one. For one, it took up entirely too much memory. Also, I had a discovered a few bugs and I didn't think that it followed the game of Yahtzee! exactly. So, I decided to make my game exactly like the game Yahtzee! This game took about a week to create and about a month total including time to add finishing touches. Now I am 99% sure that this game is bug-free. I am confident that this is the one of the best and one of the most compact games of Yahtzee! available for the TI-83 Plus. However, if you encounter any bugs or have any suggestions, please E-Mail me at BigTSkills@excite.com.

Controls for Yahtzee v2.0-
At the Home Screen-	Up:		Moves Cursor Up
			Down:		Moves Cursor Down
			Enter:		Selects Choice

While Rolling Dice-	Enter: 		Rolls Dice Each Time
			Y=		Holds First Die
			WINDOW		Holds Second Die
			ZOOM		Holds Third Die
			TRACE		Holds Fourth Die
			GRAPH		Holds Fifth Die

When Selecting Score Slot-Up:		Moves Cursor Up	
			Down:		Moves Cursor Down
			2nd:		Goes to Upper/Lower Section
			Enter:		Selects Slot

After Selecting Score-	Enter:		Proceed to Next Turn
			2nd: 		Pause Game and Save
						
Features of Yahtzee v2.0-
-MirageOS Compatible
-Very Compact
-Unlimited Yahtzee!'s
-Save/Load Game Option
-Companion Cheat Program
-To my Knowledge, It is FREE of bugs.
-The only Yahtzee game for the TI-83 or TI-83 Plus that follows Yahtzee! exactly.

Memory Requirements for Yahtzee v2.0-
This is the amount of space each of the components of Yahtzee v2.0 takes up on my TI-83 Plus. You should have at least 6262 free bytes of RAM to run Yahtzee v2.0 (not including a saved game); however, to store it you will only need 5390 bytes. This is by far the most compact game of Yahtzee I've seen. Others are 9,000-10,000+ bytes.

prgmXCHK		228
prgmXDCE		78
prgmXDSC		629
prgmXTST		1079
prgmXYMN		2153
prgmXYON		413
prgmXYP1		63
prgmXYP2		63
prgmXYP3		63
prgmXYP4		63
prgmXYP5		63
prgmXYP6		63
prgmYAHTZEE		117
prgmZRST		142
TOTAL			5217
 
Brief Descriptions of Each Component of Yahtzee v2.0-
The following is quite complex and I'll try to explain it to the best of my ability; however, it is difficult to understand unless
you understand the program very well.

prgmXCHK		This program checks to make sure that you the score slot you 			select is not already taken.
prgmXDCE		This program displays the dice along the right side of the 			screen while you are selecting the score slot.
prgmXDSC		This program displays your different scores at the score slot 			select screen.
prgmXTST		This program makes sure that your roll meets the 				requirements of the score slot you selected.
prgmXYMN		This is the main program used to run Yahtzee V. 1.0.
prgmXYON		This is the opening menu screen.
prgmXYP1		Displays dice if the roll is a one.
prgmXYP2		Displays dice if the roll is a two.
prgmXYP3		Displays dice if the roll is a three.
prgmXYP4		Displays dice if the roll is a four.
prgmXYP5		Displays dice if the roll is a five.
prgmXYP6		Displays dice if the roll is a six.
prgmYAHTZEE		This is the program that clears a few lists and is the one 			through which you open Yahtzee V. 1.0
prgmZRST		This program deletes variables and also clears lists.
L3*			Your current roll
L4*			Some complex random numbers
L5*			Upper Section of Scorecard
L6*			Lower Section of Scorecard
Pic8*			Main Screen Template
YHS			The High Score
YS1^			Component Used to Store a Saved Game
YS2^			Component Used to Store a Saved Game
Str0			The string that contains the name of the person with the High Score.

*Deleted at the end of the program.
^Only needed if you are saving a game or loading a game.

Error Messages You May Encounter on Yahtzee v2.0-
Almost all of these error messages are beyond my control and can occur in all BASIC programs.

ERR: BREAK		This occurs if you press ON during the program.
ERR: ARCHIVED		This only occurs if you have a TI-83 Plus. It happens when one 			of the components listed above is archived. None of the 			Variables (A-Z and the theta) can be archived either.
ERR:UNDEFINED		This occurs if you try to load a game that has not been saved.
ERR:MEMORY		This will occur if you run out of RAM or ARC while playing 			Yahtzee v2.0.

Companion Cheat Program-
Takes up 1477 bytes. I have not decided how to release it yet.If you have any ideas, please e-mail me.

The Future of Yahtzee v2.0-
-Add 2 Player and 2 Player Link Play
-Make even more compact.
-Write in Assembly Language.
-More advanced Cheat Program.

Disclaimer-
This game is not written in assembly and this shouldn't be a problem, but just in case, I am not responsible for any damage
caused to your TI-83, TI-83 Plus, or operating device as a result of Yahtzee v2.0. 

Duplication Information-
Because you have read this, you can distribute this game as much as you like. Although it is locked, please don't take my 
name out of it. I worked some time on this any I think that I deserve the credit, not you. If you have not read this, you can still 
distribute Yahtzee v2.0; however, you might not fully enjoy it without reading the instructions. (SEE ABOVE)

This is all and thank you for taking the time to read this. And again, if you have any questions, suggestions,
etc., E-Mail me at BigTSkills@excite.com.